home *** CD-ROM | disk | FTP | other *** search
/ Internet Info 1994 March / Internet Info CD-ROM (Walnut Creek) (March 1994).iso / inet / internet-drafts / draft-pusateri-ipmulti-mib-00.txt < prev    next >
Text File  |  1993-07-08  |  19KB  |  659 lines
  1.  
  2.  
  3.  
  4.  
  5.                                                              T. Pusateri
  6. INTERNET DRAFT                                                Consultant
  7. Expiration date: September 1993                                June 1993
  8.  
  9.  
  10.          Managed Objects for the IP Multicast Forwarding Table
  11.  
  12.  
  13.  
  14. 1.  Abstract
  15.  
  16.  
  17.  
  18. This memo defines a portion of the Management Information Base (MIB) for
  19. use with network management protocols in TCP/IP based internets.  In
  20. particular it defines objects for managing the IP Multicast Forwarding
  21. Table. IP Multicast Extensions are defined in RFC 1112 [1].
  22.  
  23.  
  24. 2.  Status of this Memo
  25.  
  26.  
  27.  
  28. This document will be submitted to the RFC editor as an extension to the
  29. SNMP MIB.  Distribution of this memo is unlimited.  Please send comments
  30. to the authors.
  31.  
  32. This document is an Internet Draft.  Internet Drafts are working
  33. documents of the Internet Engineering Task Force (IETF), its Areas, and
  34. its Working Groups. Note that other groups may also distribute working
  35. documents as Internet Drafts.
  36.  
  37. Internet Drafts are draft documents valid for a maximum of six months.
  38. Internet Drafts may be updated, replaced, or obsoleted by other
  39. documents at any time.  It is not appropriate to use Internet Drafts as
  40. reference material or to cite them other than as a "working draft" or
  41. "work in progress."
  42.  
  43. Please check the I-D abstract listing contained in each Internet Draft
  44. directory to learn the current status of this or any other Internet
  45. Draft.
  46.  
  47.  
  48. 3.  The Network Management Framework
  49.  
  50.  
  51.  
  52. The Internet-standard Network Management Framework consists of three
  53.  
  54.  
  55.  
  56. Pusateri                                                        [Page 1]
  57.  
  58.  
  59.  
  60.  
  61.  
  62. INTERNET DRAFT                                             February 1993
  63.  
  64.  
  65. components.  They are:
  66.  
  67. RFC 1155 [2]
  68.      which defines the SMI, the mechanisms used for describing and
  69.      naming objects for the purpose of management.  RFC 1212 [3] defines
  70.      a more concise description mechanism, which is wholly consistent
  71.      with the SMI.
  72.  
  73.  
  74. RFC 1156 [4]
  75.      which defines MIB-I, the core set of managed objects for the
  76.      Internet suite of protocols.  RFC 1213 [5], defines MIB-II, an
  77.      evolution of MIB-I based on implementation experience and new
  78.      operational requirements.
  79.  
  80.  
  81. RFC 1157 [6]
  82.      which defines the SNMP, the protocol used for network access to
  83.      managed objects.
  84.  
  85.      The Framework permits new objects to be defined for the purpose of
  86.      experimentation and evaluation.
  87.  
  88.  
  89. 4.  Objects
  90.  
  91.  
  92.  
  93. Managed objects are accessed via a virtual information store, termed the
  94. Management Information Base or MIB.  Objects in the MIB are defined
  95. using the subset of Abstract Syntax Notation One (ASN.1) [7] defined in
  96. the SMI.  In particular, each object has a name, a syntax, and an
  97. encoding.  The name is an object identifier, an administratively
  98. assigned name, which specifies an object type.  The object type together
  99. with an object instance serves to uniquely identify a specific
  100. instantiation of the object.  For human convenience, we often use a
  101. textual string, termed the OBJECT DESCRIPTOR, to also refer to the
  102. object type.
  103.  
  104. The syntax of an object type defines the abstract data structure
  105. corresponding to that object type.  The ASN.1 language is used for this
  106. purpose.  However, the SMI purposely restricts the ASN.1 constructs
  107. which may be used.  These restrictions are explicitly made for
  108. simplicity.
  109.  
  110. The encoding of an object type is simply how that object type is
  111. represented using the object type's syntax.  Implicitly tied to the
  112. notion of an object type's syntax and encoding is how the object type is
  113.  
  114.  
  115.  
  116. Pusateri                                                        [Page 2]
  117.  
  118.  
  119.  
  120.  
  121.  
  122. INTERNET DRAFT                                             February 1993
  123.  
  124.  
  125. represented when being transmitted on the network.
  126.  
  127. The SMI specifies the use of the basic encoding rules of ASN.1 [8],
  128. subject to the additional requirements imposed by the SNMP.
  129.  
  130. Format of Definitions
  131.  
  132.  
  133. Section 6 contains the specification of all object types contained in
  134. this MIB module.  The object types are defined using the conventions
  135. defined in the SMI, as amended by the extensions specified in RFC1212.
  136.  
  137.  
  138. 5.  Overview
  139.  
  140.  
  141.  
  142. The IP multicast forwarding mib is intended to provide a protocol
  143. independent method to monitor the IP multicast forwarding cache.
  144. Protocol dependent information (such as tunnels) should be stored in a
  145. protocol specific mib pointed to by ipMulticastForwardInfo.
  146.  
  147. Each forwarding cache entry is identified by a Group Address, Source
  148. Network pair. The Source Network is described by the
  149. ipMulticastForwardSourceNet and ipMulticastForwardSourceMask variables.
  150. Each entry is also indexed by ipMulticastForwardPolicy to allow for
  151. different TOS requirements.
  152.  
  153. For each entry there is an upstream interface and (downstream interface,
  154. TTL) pairs. This requires that the table be indexed by
  155. ipMultiDownstreamIfIndex to allow for forwarding the multicast datagram
  156. out multiple interfaces if they lie on the shortest path multicast tree.
  157.  
  158.  
  159.  
  160.  
  161.  
  162.  
  163.  
  164.  
  165.  
  166.  
  167.  
  168.  
  169.  
  170.  
  171.  
  172.  
  173.  
  174.  
  175.  
  176. Pusateri                                                        [Page 3]
  177.  
  178.  
  179.  
  180.  
  181.  
  182. INTERNET DRAFT                                             February 1993
  183.  
  184.  
  185. 6. Definitions
  186.  
  187.  
  188.  
  189. IPMULTI-FORWARDING-MIB DEFINITIONS ::= BEGIN
  190.  
  191.     IMPORTS
  192.              IpAddress, Counter, Gauge, experimental
  193.                      FROM RFC1155-SMI
  194.              OBJECT-TYPE
  195.                      FROM RFC-1212;
  196.  
  197.     -- This MIB module defines an information base for the
  198.     -- IP Multicast Forwarding Table.
  199.     -- It is based on the specification found in RFC 1112.
  200.  
  201.     -- Please send any comments to Tom Pusateri (pusateri@cs.duke.edu).
  202.  
  203.     -- Thanks to John Moy and Greg Minshall for their review and comments.
  204.     -- $Id: ipmultiforward.mib,v 1.5 1993/06/23 02:19:47 pusateri Exp $
  205.  
  206.     ipMulticastForward  OBJECT IDENTIFIER ::= { experimental xxx }
  207.  
  208.     ipMulticastForwarding OBJECT-TYPE
  209.         SYNTAX  INTEGER {
  210.                 forwarding(1),          -- acting as a multicast router
  211.                 not-forwarding(2)       -- NOT acting as a multicast router
  212.         }
  213.         ACCESS  read-write
  214.         STATUS  mandatory
  215.         DESCRIPTION
  216.                 "The indication of whether this entity is acting as
  217.                 an IP Multicast gateway in respect to the forwarding
  218.                 of CLASS D datagrams received by this entity."
  219.         ::= { ipMulticastForward 1 }
  220.  
  221.     ipMulticastForwardNumber OBJECT-TYPE
  222.         SYNTAX   Gauge
  223.         ACCESS   read-only
  224.         STATUS   mandatory
  225.         DESCRIPTION
  226.                 "The number of current  ipMulticastForwardTable  entries
  227.                 that are not invalid."
  228.         ::= { ipMulticastForward 2 }
  229.  
  230.     --  IP Multicast Forwarding Table
  231.  
  232.     ipMulticastForwardTable OBJECT-TYPE
  233.  
  234.  
  235.  
  236. Pusateri                                                        [Page 4]
  237.  
  238.  
  239.  
  240.  
  241.  
  242. INTERNET DRAFT                                             February 1993
  243.  
  244.  
  245.         SYNTAX   SEQUENCE OF IpMulticastForwardEntry
  246.         ACCESS   not-accessible
  247.         STATUS   mandatory
  248.         DESCRIPTION
  249.                 "This entity's IP Multicast forwarding table."
  250.         ::= { ipMulticastForward 3 }
  251.  
  252.     ipMulticastForwardEntry OBJECT-TYPE
  253.         SYNTAX   IpMulticastForwardEntry
  254.         ACCESS   not-accessible
  255.         STATUS   mandatory
  256.         DESCRIPTION
  257.                 "A forwarding entry based on source network/destination
  258.                 group under a particular policy."
  259.         INDEX {
  260.             ipMulticastForwardGroup,
  261.             ipMulticastForwardSourceNet,
  262.             ipMulticastForwardSourceMask,
  263.             ipMulticastForwardPolicy,
  264.             ipMultiDownstreamIfIndex
  265.         }
  266.         ::= { ipMulticastForwardTable 1 }
  267.  
  268.     IpMulticastForwardEntry ::=
  269.         SEQUENCE {
  270.             ipMulticastForwardGroup
  271.                 IpAddress,
  272.             ipMulticastForwardSourceNet
  273.                 IpAddress,
  274.             ipMulticastForwardSourceMask
  275.                 IpAddress,
  276.             ipMultiUpstreamIfIndex
  277.                 INTEGER,
  278.             ipMultiDownstreamIfIndex
  279.                 INTEGER,
  280.             ipMultiDownstreamTTL
  281.                 INTEGER,
  282.             ipMulticastForwardProto
  283.                 INTEGER,
  284.             ipMulticastForwardPolicy
  285.                 INTEGER,
  286.             ipMulticastForwardAge
  287.                 INTEGER,
  288.             ipMulticastForwardedDatagrams
  289.                 Counter,
  290.             ipMulticastForwardInfo
  291.                 OBJECT IDENTIFIER
  292.         }
  293.  
  294.  
  295.  
  296. Pusateri                                                        [Page 5]
  297.  
  298.  
  299.  
  300.  
  301.  
  302. INTERNET DRAFT                                             February 1993
  303.  
  304.  
  305.     ipMulticastForwardGroup OBJECT-TYPE
  306.         SYNTAX   IpAddress
  307.         ACCESS   read-only
  308.         STATUS   mandatory
  309.         DESCRIPTION
  310.             "The destination IP Multicast Group Address. The
  311.             range of this address is defined in RFC 1112. It
  312.             is also referred to as a Class D address."
  313.         ::= { ipMulticastForwardEntry 1 }
  314.  
  315.     ipMulticastForwardSourceNet OBJECT-TYPE
  316.         SYNTAX   IpAddress
  317.         ACCESS   read-only
  318.         STATUS   mandatory
  319.         DESCRIPTION
  320.             "The source address of the IP Mulicast datagram.
  321.             This is required for Multicast Routing Protocol
  322.             performing Reverse Path Forwarding."
  323.         ::= { ipMulticastForwardEntry 2 }
  324.  
  325.     ipMulticastForwardSourceMask OBJECT-TYPE
  326.         SYNTAX   IpAddress
  327.         ACCESS   read-only
  328.         STATUS   mandatory
  329.         DESCRIPTION
  330.             "The source network mask of the IP Mulicast datagram.
  331.             This is required for Multicast Routing Protocol
  332.             performing Reverse Path Forwarding to uniquely
  333.             identify the source network."
  334.         ::= { ipMulticastForwardEntry 3 }
  335.  
  336.     ipMultiUpstreamIfIndex OBJECT-TYPE
  337.         SYNTAX   INTEGER
  338.         ACCESS   read-only
  339.         STATUS   mandatory
  340.         DESCRIPTION
  341.            "This value is a unique integer for each interface as
  342.             identified by the same value of IfIndex. It specifies
  343.             the interface an IP Multicast datagram is required to
  344.             be received on in order to be forwarded to the
  345.             downstream interface in the same entry of this table."
  346.         ::= { ipMulticastForwardEntry 4 }
  347.  
  348.     ipMultiDownstreamIfIndex OBJECT-TYPE
  349.         SYNTAX   INTEGER
  350.         ACCESS   read-only
  351.         STATUS   mandatory
  352.         DESCRIPTION
  353.  
  354.  
  355.  
  356. Pusateri                                                        [Page 6]
  357.  
  358.  
  359.  
  360.  
  361.  
  362. INTERNET DRAFT                                             February 1993
  363.  
  364.  
  365.            "This value is a unique integer for each interface as
  366.             identified by the same value of IfIndex. It specifies
  367.             the interface an IP Multicast datagram  should be
  368.             forwarded out of given that it was received on the
  369.             upstream interface in the same entry of this table.
  370.             Before forwarding occurs, the datagram's TTL field
  371.             must also be greater than or equal to the TTL field
  372.             in the same entry of this table."
  373.         ::= { ipMulticastForwardEntry 5 }
  374.  
  375.     ipMultiDownstreamTTL OBJECT-TYPE
  376.         SYNTAX   INTEGER
  377.         ACCESS   read-only
  378.         STATUS   mandatory
  379.         DESCRIPTION
  380.             "The required minimum TTL for an IP Multicast Datagram
  381.             to reach the closest group member. If the TTL value
  382.             in the IP header of the IP Multicast datagram is not
  383.             at least this large, there is no reason to further
  384.             forward the datagram. This field is frequently used
  385.             for locating resources using the expanding ring search."
  386.         ::= { ipMulticastForwardEntry 6 }
  387.  
  388.     ipMulticastForwardProto OBJECT-TYPE
  389.         SYNTAX   INTEGER {
  390.                     other     (1),  -- not specified
  391.                     local     (2),  -- local interface
  392.                     netmgmt   (3),  -- static route
  393.                     dvmrp     (4),  -- Distance Vector Multicast Routing
  394.                     mospf     (5)   -- Multicast Open Shortest Path First
  395.                  }
  396.         ACCESS   read-only
  397.         STATUS   mandatory
  398.         DESCRIPTION
  399.            "The routing mechanism via which this route was
  400.            learned."
  401.         ::= { ipMulticastForwardEntry 7 }
  402.  
  403.     ipMulticastForwardPolicy OBJECT-TYPE
  404.         SYNTAX   INTEGER
  405.         ACCESS   read-only
  406.         STATUS   mandatory
  407.         DESCRIPTION
  408.            "The general set of conditions that would cause
  409.            the selection of one multipath route (set of
  410.            next hops for a given destination) is referred
  411.            to as 'policy'.
  412.  
  413.  
  414.  
  415.  
  416. Pusateri                                                        [Page 7]
  417.  
  418.  
  419.  
  420.  
  421.  
  422. INTERNET DRAFT                                             February 1993
  423.  
  424.  
  425.            Unless the mechanism indicated by ipForwardProto
  426.            specifies otherwise, the policy specifier is the
  427.            IP TOS Field.  The encoding of IP TOS is as
  428.            specified by the following convention.  Zero
  429.            indicates the default path if no more specific
  430.            policy applies.
  431.  
  432.            +-----+-----+-----+-----+-----+-----+-----+-----+
  433.            |                 |                       |     |
  434.            |   PRECEDENCE    |    TYPE OF SERVICE    |  0  |
  435.            |                 |                       |     |
  436.            +-----+-----+-----+-----+-----+-----+-----+-----+
  437.  
  438.                     IP TOS                IP TOS
  439.                Field     Policy      Field     Policy
  440.                Contents    Code      Contents    Code
  441.                0 0 0 0  ==>   0      0 0 0 1  ==>   2
  442.                0 0 1 0  ==>   4      0 0 1 1  ==>   6
  443.                0 1 0 0  ==>   8      0 1 0 1  ==>  10
  444.  
  445.  
  446.                0 1 1 0  ==>  12      0 1 1 1  ==>  14
  447.                1 0 0 0  ==>  16      1 0 0 1  ==>  18
  448.                1 0 1 0  ==>  20      1 0 1 1  ==>  22
  449.                1 1 0 0  ==>  24      1 1 0 1  ==>  26
  450.                1 1 1 0  ==>  28      1 1 1 1  ==>  30
  451.  
  452.            Protocols defining 'policy' otherwise must either
  453.            define a set of values which are valid for this
  454.            object or must implement an integer-instanced
  455.            policy table for which this object's value acts
  456.            as an index."
  457.         ::= { ipMulticastForwardEntry 8 }
  458.  
  459.     ipMulticastForwardAge OBJECT-TYPE
  460.         SYNTAX   INTEGER
  461.         ACCESS   read-only
  462.         STATUS   mandatory
  463.         DESCRIPTION
  464.            "The number of seconds  since  this  route  was
  465.            last  updated  or  otherwise  determined  to be
  466.            correct.  Note that no semantics of  `too  old'
  467.            can  be implied except through knowledge of the
  468.            routing  protocol  by  which  the   route   was
  469.            learned."
  470.         DEFVAL  { 0 }
  471.         ::= { ipMulticastForwardEntry 9 }
  472.  
  473.  
  474.  
  475.  
  476. Pusateri                                                        [Page 8]
  477.  
  478.  
  479.  
  480.  
  481.  
  482. INTERNET DRAFT                                             February 1993
  483.  
  484.  
  485.     ipMulticastForwardedDatagrams OBJECT-TYPE
  486.         SYNTAX   Counter
  487.         ACCESS   read-only
  488.         STATUS   mandatory
  489.         DESCRIPTION
  490.            "The number of IP Multicast datagrams that have
  491.             been forwarded from the upstream interface listed
  492.             in this entry to the downstream interface listed
  493.             in this entry. Note that because there could be
  494.             multiple downstream interfaces in this table for
  495.             the same (source network, destination group), this
  496.             number may not be the same as the number of
  497.             IP multicast datagrams received on the upstream
  498.             interface for a particular (source network, destination
  499.             group)."
  500.         ::= { ipMulticastForwardEntry 10 }
  501.  
  502.     ipMulticastForwardInfo OBJECT-TYPE
  503.         SYNTAX   OBJECT IDENTIFIER
  504.         ACCESS   read-write
  505.         STATUS   mandatory
  506.         DESCRIPTION
  507.             "A reference to MIB definitions specific to the
  508.             particular routing protocol which is responsible
  509.             for this route, as determined by the value specified
  510.             in the route's ipMulticastForwardProto value. If
  511.             this information is not present,  its value
  512.             should be set to the OBJECT IDENTIFIER { 0 0 },
  513.             which is a syntactically valid object identifier,
  514.             and any implementation conforming to ASN.1
  515.             and the Basic Encoding Rules must be able to
  516.             generate and recognize this value."
  517.         DEFVAL  { { 0 0 } } -- 0.0
  518.         ::= { ipMulticastForwardEntry 11 }
  519. END
  520.  
  521.  
  522. 7.  Acknowledgments
  523.  
  524.  
  525.  
  526.    The author would like to thank John Moy and Greg Minshall for their
  527.    review and constructive comments.
  528.  
  529.  
  530.  
  531.  
  532.  
  533.  
  534.  
  535.  
  536. Pusateri                                                        [Page 9]
  537.  
  538.  
  539.  
  540.  
  541.  
  542. INTERNET DRAFT                                             February 1993
  543.  
  544.  
  545. Author's  Address:
  546.  
  547.    Thomas J. Pusateri
  548.    Consultant
  549.    11820 Edgewater Ct.
  550.    Raleigh, NC 27614
  551.  
  552.    pusateri@cs.duke.edu
  553.  
  554.  
  555. 8.0 References
  556.  
  557.  
  558.  
  559. [1]  S. Deering, Host Extensions for IP Multicasting, Internet Working
  560.      Group Request for Comments 1112.  Network Information Center, SRI
  561.      International, Menlo Park, California, (Aug, 1989).
  562.  
  563.  
  564. [2]  M.T. Rose and K. McCloghrie, Structure and Identification of
  565.      Management Information for TCP/IP-based internets, Internet Working
  566.      Group Request for Comments 1155.  Network Information Center, SRI
  567.      International, Menlo Park, California, (May, 1990).
  568.  
  569.  
  570. [3]  M.T. Rose, Concise MIB definitions Internet Working Group Request
  571.      for Comments 1212.  Network Information Center, SRI International,
  572.      Menlo Park, California, (March, 1991).
  573.  
  574.  
  575. [4]  K. McCloghrie and M.T. Rose, Management Information Base for
  576.      Network Management of TCP/IP-based internets, Internet Working
  577.      Group Request for Comments 1156.  Network Information Center, SRI
  578.      International, Menlo Park, California, (May, 1990).
  579.  
  580.  
  581. [5]  M.T. Rose (editor), Management Information Base for Network
  582.      Management of TCP/IP-based internets, Internet Working Group
  583.      Request for Comments 1213.  Network Information Center, SRI
  584.      International, Menlo Park, California, (March, 1991).
  585.  
  586.  
  587. [6]  J.D. Case, M.S. Fedor, M.L. Schoffstall, and J.R. Davin, Simple
  588.      Network Management Protocol, Internet Working Group Request for
  589.      Comments 1157.  Network Information Center, SRI International,
  590.      Menlo Park, California, (May, 1990).
  591.  
  592.  
  593.  
  594.  
  595.  
  596. Pusateri                                                       [Page 10]
  597.  
  598.  
  599.  
  600.  
  601.  
  602. INTERNET DRAFT                                             February 1993
  603.  
  604.  
  605. [7]  Information processing systems - Open Systems Interconnection -
  606.      Specification of Abstract Syntax Notation One (ASN.1),
  607.      International Organization for Standardization.  International
  608.      Standard 8824, (December, 1987).
  609.  
  610.  
  611. [8]  Information processing systems - Open Systems Interconnection -
  612.      Specification of Basic Encoding Rules for Abstract Notation One
  613.      (ASN.1), International Organization for Standardization.
  614.      International Standard 8825, (December, 1987).
  615.  
  616.  
  617.  
  618.  
  619.  
  620.  
  621.  
  622.  
  623.  
  624.  
  625.  
  626.  
  627.  
  628.  
  629.  
  630.  
  631.  
  632.  
  633.  
  634.  
  635.  
  636.  
  637.  
  638.  
  639.  
  640.  
  641.  
  642.  
  643.  
  644.  
  645.  
  646.  
  647.  
  648.  
  649.  
  650.  
  651.  
  652.  
  653.  
  654.  
  655.  
  656. Pusateri                                                       [Page 11]
  657.  
  658.  
  659.